home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _printapps / printapps / _printemul / !PRINTEMUL / !HELP < prev    next >
Text File  |  1991-04-21  |  6KB  |  149 lines
  1. Help file accompagning the !PrintEmul application :
  2. ***************************************************
  3.  
  4. ***************************  Copyright Notice  **************************
  5. *                                                                       *
  6. *   The object code and documentation for the '!Dissi' application are  *
  7. *   the exclusive copyright of John TYTGAT and are freely               *
  8. *   distributable, provided this notice is left intact and all of the   *
  9. *   files listed below are included, UNALTERED.                         *
  10. *                                                                       *
  11. *************************************************************************
  12.  
  13. Included : 
  14. ========
  15.            (1) !Boot & !Run file
  16.            (2) !Help file (= this text !)
  17.            (3) !RunImage (= main program)
  18.            (4) Template file
  19.            (5) !Sprite file
  20.  
  21. AIM :
  22. ===
  23.  
  24. As you probably already guessed : !PrintEmul is a EPSON FX compatible
  25. printer emulator.  It reads a printer file (filetype &FF4, "PrintOut")
  26. generated by the RISC OS printer driver application !PrinterDM (⌐ Acorn
  27. Computers Ltd.) and shows the output on the screen in a window.
  28.  
  29. !PrintEmul is only a graphics emulator.  There will be an error given when
  30. the user tries to emulate text ASCII values.
  31.  
  32. This output can be saved as a MODE 0 sprite file (1985 by 2526 pixels).
  33.        
  34. Why ?
  35. ===
  36.  
  37. I wrote this small application because I am writing an another application
  38. (called !FontDump) that works with the RISC OS printer drivers.  While
  39. testing !FontDump I didn't want to wait each time for a printed page so I am
  40. actually now printing to a file and look if !FontDump correctly works using
  41. !PrintEmul !
  42.  
  43. !FontDump will be a P.D. program and prints a test page of a selected font
  44. (containing different points of that font and the complete character set).
  45. It works correctly with the Acorn printer drivers (!PrinterDM, !PrinterLJ,
  46. ...) but I tried it once with a Computer Concepts Laser printer (600 dpi) :
  47. Holala, the result was a completly black page ! Sorry for the toner Kees !
  48.  
  49. I don't want to accuse CC for writing not-RISC OS compatible printer drivers
  50. but I find it strange that my program works correctly with the other printer
  51. drivers and with a CC printer driver it gave me such a result... Does
  52. someone have an idea or had similar problems ?
  53.  
  54. Details :
  55. =======
  56.  
  57. Because the interpretation of the printer file takes some time, I added a
  58. multitask option.  You can find this option (default on) in the menu
  59. obtained by clicking on the !PrintEmul icon.  During the multitask
  60. interpretation !PrintEmul opens a window with a white background and then it
  61. is not possible to select a menu option.
  62. When the pointer is over the window you can see which amounth of the printer
  63. file is already interpretated.
  64.  
  65. In the same menu tree there is also the option 'Clear'.  When selecting
  66. 'Clear' the !PrintEmul deletes the created sprite file in its internal
  67. memory.
  68.  
  69. The !PrintEmul application emulates just the first printed page of the
  70. printer file.  It is only a graphics emulation of :
  71.  
  72.     (1) Single density    ( 60 x  72 dpi)    Code <ESC> <"K">
  73.     (2) Double density    (120 x 144 dpi)    Code <ESC> <"L">
  74.     (3) Quadruple density (240 x 216 dpi)    Code <ESC> <"Z">
  75.  
  76. If someone can pass me the codes & formats of other dot matrix printers (ex.
  77. EPSON LQ-850 compatible, NEC PinWriter P6 plus, EPSON LQ compatible, HP
  78. Laser, ...) I will try to implement it ! I need not only the codes for the
  79. graphics dump but also the format how they encode the graphics information
  80. and I need also the codes for setting the right line spacing, etc.
  81.  
  82. In the main menu there is the option 'About' : this option reveals a window
  83. where you can see which graphics density is used (single, double, quadruple
  84. density) in the printer file and some other information.
  85.  
  86. KNOWN ERRORS :
  87. ============
  88.  
  89. (*) 'Emulation error 1 : &<number1>, PNTR at &<number2>'
  90. This error means that there is an unknown character number <number1> in the
  91. file at position <number2>.
  92.  
  93. (*) 'Emulation error 2 : &<number1> "<character>", PNTR at &<number2>'
  94. This error means that there is an unknown escape code <number1> (or ASCII
  95. equivalent <character>) in the file at position <number2>.
  96.  
  97. BASS :
  98. ====
  99.  
  100. !PrintEmul is released as a BASS product.  BASS (Belgian Archimedes
  101. Software-writers Society) is group of young enthousiast software-writers who
  102. like to write Archimedes public domain programs.  If you want to know more
  103. about us, please feel free to contact us !
  104.  
  105. Versions :
  106. ========
  107.  
  108. v1.00 (27-Mar-1991) : First released in public domain
  109. v1.01 (20-Apr-1991) : Small changes :
  110.     (*) Clicking on a 'PrintOut' file will automatically be emulated
  111.     (*) Shading the 'Clear' option when it is not relevant
  112.     (*) Allow scrolling & moving of the window while emulating
  113. v1.02 (21-Apr-1991) :
  114.     (*) Check added if user wants to quit program/clear workspace without
  115. saving his/her results.
  116.  
  117. Conditions of use :
  118. =================
  119.  
  120. This software is supplied "as is"; no warranty, express or implied, of the
  121. merchantability of this software or its fitness for any particular purpose
  122. is given.  In no circumstances shall the providers of this software be
  123. liable for any damage, loss of profits, or any indirect or consequential
  124. loss arising out of the use of this software or inability to use this
  125. software.
  126.  
  127. You are free to give this application to anyone you please via any medium,
  128. provided it is delivered with ALL the supplied files, UNALTERED.  You may
  129. NOT sell this software, or use it otherwise for personal gain.  If you wish
  130. to post it on your Bulletin Board or include it in your Shareware library
  131. then that, too, is fine.
  132.  
  133. A large number of hours of work have gone into the production and
  134. maintenance of this application and although I have supplied the application
  135. free, donations will be gratefully received.
  136.  
  137. Please report any bugs you find to me, so that other users may benefit from
  138. improved versions.  I cannot guarantee to fix any bugs, but I will do my
  139. best.
  140.  
  141.  
  142. My address is:
  143.  
  144. John TYTGAT
  145. Brusselbaan 445
  146. B-1600 St.-Pieters-Leeuw
  147. BELGIUM
  148.  
  149. ⌐ BASS 1991